Appendix A - DSSP examples 



1. DSS Query Response 

<response> 

<sheet path="/ expenses" name=" january"> 
<cell row="5" col="a">13 . 2</cell> 

</ sheet> 
</ response> 

In this example, the relevant value is 13.2 ♦ The XML file contains additional 
information, such as the path and name of the spreadsheet, and the row and 
column of the desired cell. This is to allow the client application to verify 
that the response it received is valid. 

It is possible to imagine extending the query mechanism to allow clients to 
access groups of cells in one request. In that case, the cell information would 
simply be listed as multiple 'cell 1 child elements of the 'sheet 1 group, as 
follows : 

<response> 

<sheet path=" /expenses" name= n january"> 

<cell row="5" cols= w a ,, >13. 2</cell> 

<cell row="6" col="a">14 . 5</cell> 

<cell row="7" col="a">15 . 6</cell> 
</sheet> 
</ response> 

2. DSS Command 

<command code="addcell"> 

<sheet path =ll /expenses" name=" january"> 
<cell col="c" value-"14.5"/> 

</sheet> 
</command> 

In this example, a client application has sent a message to the DSS server 
indicating that it desires to add a cell to a given spreadsheet. The spreadsheet 
name and path is given, as well as the value of the cell to add - 14.5 . 
Additionally, the column to add the cell to is specified. In this case the cell 
will be added to the row after the last non-null cell in column ' c* . 

<command code-"adduser"> 

<user name="burfoot" password="zodanl23"/> 
</command> 

This DSS command instructs the DSS server to add the user "burfoot" with 
password "zodanl23". Note that this transmission will be secured through use of 
SSL. 

3. DSS Command Response 
<commandresponse code="success"/> 

This simple command response indicates that the command issued by the DSS client 
was successful. 



<commandresponse code~"f ailure"/> 

<error code="4">The user name 'burfoot' is already in use.</error> 
</commandresponse> 

This command response designates failure, gives an error code (4), and a 
description of the reason for the failure of the command. 
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